home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3c / sem_destroy.z / sem_destroy
Encoding:
Text File  |  2002-10-03  |  2.7 KB  |  66 lines
  1.  
  2.  
  3.  
  4. sssseeeemmmm____ddddeeeessssttttrrrrooooyyyy((((3333CCCC))))                                                sssseeeemmmm____ddddeeeessssttttrrrrooooyyyy((((3333CCCC))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _ssss_eeee_mmmm______dddd_eeee_ssss_tttt_rrrr_oooo_yyyy - deinitialize a posix unnamed semaphore
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_eeee_mmmm_aaaa_pppp_hhhh_oooo_rrrr_eeee_...._hhhh_>>>>
  13.      _iiii_nnnn_tttt _ssss_eeee_mmmm______dddd_eeee_ssss_tttt_rrrr_oooo_yyyy_((((_ssss_eeee_mmmm______tttt _****_s_e_m_))))_;;;;
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _ssss_eeee_mmmm______dddd_eeee_ssss_tttt_rrrr_oooo_yyyy deinitializes the unnamed semaphore located at address _s_e_m.
  17.      The address _s_e_m may reside anywhere in the calling processes address
  18.      space, but the process must have read and write access to _s_e_m.
  19.  
  20.      Once an unnamed semaphore has been deinitialized, semaphore operations
  21.      performed on it will fail until the semaphore has been reinitialized.
  22.  
  23.      _ssss_eeee_mmmm______dddd_eeee_ssss_tttt_rrrr_oooo_yyyy will fail if one or more of the following are true:
  24.  
  25.      [EINVAL]    The semaphore located at address _s_e_m is not a valid posix
  26.                  unnamed semaphore.
  27.  
  28.      [EBUSY]     The system has detected processes currently blocked on the
  29.                  semaphore. This condition may not be detected if a _ssss_eeee_mmmm______pppp_oooo_ssss_tttt
  30.                  operation is executed at the same time as the _ssss_eeee_mmmm______dddd_eeee_ssss_tttt_rrrr_oooo_yyyy
  31.                  operation.
  32.  
  33. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  34.      sem_init(3C), sem_getvalue(3C), sem_post(3C), sem_wait(3C),
  35.      sem_trywait(3C), sem_open(3C), sem_close(3C), sem_unlink(3C),
  36.      shm_open(3C), mmap(3C)
  37.  
  38. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  39.      Upon successful completion, a value of 0 is returned to the calling
  40.      process. Otherwise, a value of -1 is returned and _eeee_rrrr_rrrr_nnnn_oooo is set to
  41.      indicate the error.
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.